home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 27.zip / BS1 part 27 / VidTrackDevelop1.adf / VideoTracker_Doc.pp / VideoTracker_Doc
Text File  |  1993-08-09  |  69KB  |  2,466 lines

  1.  
  2. =============================================================================
  3.             VideoTracker English V0.99 Demo Beta
  4. =============================================================================
  5.  
  6.           Created by: Peter "RattleHead" van Campen
  7.           Distributed by: Creator
  8.              Released as: FreeWare
  9.              Released on: 15-8-93
  10.                
  11.  
  12.                 Contents:
  13.                 
  14.         - What is VideoTracker ?
  15.         - VideoTracker Guideline & Interactive.
  16.         - Functions
  17.         - How to make a simple video.
  18.         - Hints
  19.         - VideoTracker Developer Kit
  20.         - Routines
  21.         - Hard Disk installation.
  22.         - Libraries
  23.         - Demo Vidules info
  24.         - About
  25.  
  26.         (Don't mind my bad english, I'm from Holland)
  27.  
  28.  
  29.  
  30. =============================================================================
  31.                What is VideoTracker ?
  32. =============================================================================
  33.  
  34. With VideoTracker you can make a videoclip around a SoundTracker-module.
  35. You can use pictures, brushes, animations, animation-brushes, palettes,
  36. colorcycle, routines, texts, objects, vectorobjects, amigafonts, karafonts,
  37. landscapes, colorsets.
  38. When the video is finished, you can save the module and video data as a
  39. "Vidule".
  40. A vidule is a crunchable executable file which plays the module and the
  41. video.
  42. You can make a small intro or a big house-demo.
  43. You also can use VideoTracker with a GenLock and, for example, make
  44. professional movie-titles with colorfonts.
  45.  
  46. When the module plays a sample, VideoTracker shows an "effect" on screen.
  47. This effect can by a picture, brush, anim, routine, etcetra. or a
  48. combination of these.
  49. You can edit for each of the 128 song-positions the 31 samples and use
  50. up to 256 effects in a video.
  51. All the explained effects are used in the example-videos.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. =============================================================================
  59.              VideoTracker Guideline & Interactive:
  60. =============================================================================
  61.  
  62. There are 2 versions of VideoTracker:
  63.  
  64. Guideline:
  65. The interface is build according to the Commodore guidelines.
  66. Advantage:    Easy to understand, multitasking.
  67. Disadvantage:    No interactive video-editing wich slows you down.
  68.         It only works on kickstart 2.0 and higher.
  69.  
  70. Interactive:
  71. The interface is directly hitting the hardware.
  72. Advantage:    Edit the video while it's playing, uses a splitscreen.
  73.         It also works on kickstart 1.3 and lower. 
  74. Disadvantage:    No multitasking, probably breaks all the Commodore
  75.         guidelines :-), sligthy delaying the routines.
  76.  
  77. Interactive gadgets:
  78. You can click all gadgets with a black background.
  79. To start a function, click with your left mousebutton on a gadget.
  80. To select a setting, use your left mousebutton to go back and your
  81. right mousebutton to go forward.
  82.  
  83. (They're both in an English and a German version.)
  84.  
  85.  
  86. =============================================================================
  87.                   Functions:
  88. =============================================================================
  89.  
  90. [Quit]        Quits VideoTracker
  91.  
  92. Vidule size:    Shows the size of the vidule in kilobytes (1024 bytes).
  93.         This includes the video-player and video-data. (50k)
  94.  
  95. Module:        Shows the name of the module in memory.
  96.  
  97. Songpos:    Shows the song-position that is currently played.
  98.         You can also use it to select the song-position you want
  99.         to edit.
  100.         Each of the 128 song-positions have its own settings for the
  101.         31 samples. (Animspeed, Effectspeed etcetra.)
  102.  
  103. Sample:        Selects the sample that you want to edit.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Priority:    Selects the priority over other samples that are played.
  115.         So the effect will not be removed by other samples with
  116.         effects.
  117.         The higher the value, the bigger the priority.
  118.         So, for example, when you have a basedrum that beats 4
  119.         times in a song-position, and a trumpet    that blows all
  120.         the time, you could let the effect(s) of the basedrum
  121.         have a bigger priority then the trumpet.
  122.         So every time you hear the basedrum, you could show
  123.         an animation of a drummer that hits a drum.
  124.         And when the trumpet plays, you could show a picture
  125.         of a trumpet.
  126.         The sample keeps the priority as long as it plays.
  127.         In the above example, the basedrum is a short sample,
  128.         the drummer-animation will be shown short, because
  129.         when the sample is over, the trumpet takes over again.
  130.         Keep this in mind when you use the effect-loop and
  131.         effect-speed, this will only work while the sample is
  132.         playing.
  133.         
  134.         Special values:
  135.         "0" The sample is off, effect will not be played.
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142. First Effect:    Is the first effect that will be shown when the sample is
  143.                 played.
  144.         The effectlist can hold maximum 256 effects.
  145.         An effect can be:
  146.         picture, brush, anim, etcetra
  147.         You can load the same effect several times into
  148.         the effectlist without extra use of memory.
  149.         When the old effect on the screen has the same
  150.         screenheigth, screenwidth, viewmode and depth of the
  151.         new effect, and when the depth is not bigger than 8 colors,
  152.         the new effect will be shown together with the old effect
  153.         using the hardware "Double Playfield" mode.
  154.         In this way you can also play animations and/or routines
  155.         at the same time.
  156.             So you can use for example a scrolltext with a
  157.             background-picture etcetra.
  158.  
  159. Last Effect:    Is the last effect that will be shown when the sample is
  160.         played.
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170. Effect speed:    Selects the speed of the effect-steps.
  171.         Special values:
  172.         The higher the value, the higher the delay.
  173.  
  174.         "0" Triggermode:
  175.         One effect is played, the following effect will be shown
  176.         when the sample is played again.
  177.  
  178.         "1" Fastmode:
  179.         All the effects are shown without any delay.
  180.         This can be usefull if you have a lot of objects or other
  181.         data-files that need to be played.
  182.  
  183. Effect Loop:     Selects if the effects will stop at the last effect or start
  184.         over again.
  185.  
  186. Anim Speed:     Selects the speed of the animframe-steps.
  187.  
  188. Anim Loop:    Selects if the anim will stop at the end or start over again.
  189.  
  190. Routine mode:    Selects the way a routine is played.
  191.         Each routine has several ways to play:
  192.         Example:    Routine: Stars
  193.                 Values:     "0" Show the stars normal.
  194.                      "1" Rotate the stars left.
  195.                      "2" Rotate the stars right.
  196.  
  197.  
  198. [Play]        Starts playing the video from the current
  199.         song-position.
  200.  
  201. [Delete]    Removes the effect that is shown in "First Effect:"
  202.         When the effect is not used in another place in the
  203.         effectlist, it will be removed from memory.
  204.  
  205. [PAL]        Selects the American viewmode (NTSC) or European
  206.         viewmode (PAL).
  207.         With the help of this, you can make a video that will work
  208.         all over the world.
  209.         American Amigas (60hz) have a slightly faster view-refreshing
  210.         then European Amigas (50hz).
  211.         So some routines who run nice on European Amigas may "shock"
  212.         on American Amigas, therefore there are special
  213.         NTSC-versions of routines who may have this problem.
  214.         
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226. Songpos:
  227.  
  228. [Copy]        Copies the current songposition to a copybuffer.
  229.         When you want to use the same songposition-effects
  230.         in another songposition, you can Copy them to the buffer,
  231.         select the other songposition and Paste the buffer to the
  232.         other songposition.
  233.  
  234. [Paste]        Copies the copybuffer to the current
  235.         songposition-settings.
  236.  
  237. Sample:
  238.  
  239. [Copy]        Copies the current sample-settings to a copybuffer.
  240.  
  241. [Paste]        Copies the copybuffer to the current sample-settings.
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.             ============================
  255.             Special Guideline functions:
  256.             ============================
  257.  
  258. [Play Songpos]    Starts playing the current song-position.
  259.  
  260. [Clean Video]    This will move all the effects in the effectlist
  261.         after eachother so free bits in the effectlist
  262.         will be removed and one large free block will
  263.         appear at the end of the effectlist.
  264.         This can be usefull when you're working on a big
  265.         video.
  266.  
  267. [Vidule Loop]    When this is on, the vidule will restart when it's
  268.         finished.
  269.         When it's off, the vidule will exit.
  270.         In this way, you can play several vidules in a row
  271.         from a partition of your harddisk, using an execute
  272.         script-file.
  273.         When you don't crunch the vidules, there will only
  274.         be a delay of 1 second.
  275.         When you make your preference screen-colors black,
  276.         there will not be a cli-screen when the next vidule
  277.         is loading.
  278.         Nice idea for a party...
  279.  
  280.  
  281.  
  282.             ==============================
  283.             Special Interactive functions:
  284.             ==============================
  285.  
  286. [Stop]        Stops playing the video.
  287.  
  288. [Back]        Removes the gadgetscreen so you can see the complete video
  289.         screen.
  290.         The gadgetscreen returns when you click the left mousebutton
  291.         again.
  292.         Interlace isn't working when the gadgetscreen is on, it's
  293.         not so healthy for your eyes when you're editting a video.
  294.         Some example-videos may "shock" a little bit, this is 
  295.         because the gadgetscreen takes a little of their
  296.         processor-time.
  297.         When you remove the gadgetscreen, the videos will work
  298.         correctly.
  299.  
  300. [-] [+]        You can use this to change the routine-mode number
  301.         with steps of 1024, which can be usefull with big
  302.         routines like "Plasma".
  303.                         
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.                 ===============
  311.                 Save functions:
  312.                 ===============
  313.  
  314. [Video]        Saves the video without module and effect data.
  315.         A video-file holds all the settings for the
  316.         anim-speed, effect-loop, etcetra, and the 
  317.         file-names of the pictures, anims, etcetra.
  318.         
  319. [Vidule]    Saves the video with module and effect data as an
  320.         executable and crunchable file.
  321.         Executable means that you can start it from the CLI
  322.         or from the WorkBench.
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338. [Effect]    Saves the effect that is shown in the "First Effect:"
  339.         gadget as a "raw" file.
  340.         This is only usefull for programmers who want to make
  341.         their own VideoTracker-routines.
  342.         VideoTracker converts the Brushes, Fonts, Vectors, etc.
  343.         to fast usable data-files, these converted files are
  344.         called "Effect-files".
  345.         When programmers want to use, for example, a font in
  346.         their routine, they can "incbin" these effect-files.
  347.         They can also use it as a raw-converter for own products.
  348.         More information is given in the example sources of the
  349.         "VideoTracker Developer Kit" wich is Public Domain.
  350.         The Kit contains all the current routine sources. (DevPac3)
  351.         You can include your routine-source in the Kit-sourcefile
  352.         and you can test them.
  353.         
  354.         
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.                 ===============
  367.                 Load functions:
  368.                 ===============
  369.  
  370. [Video]        Loads a video into memory and loads the module and
  371.         effects which are used in the video.
  372.  
  373. [Module]    Loads a module into memory.
  374.  
  375.         A module is a SoundTracker musicfile wich contains the
  376.         song and sample data.
  377.         There are many SoundTracker clones like ProTracker,
  378.         NoiseTracker etc. which are all Public Domain so you can
  379.         copy them for free.
  380.         You can use different song-speeds.
  381.         PowerPacked files can also be loaded.
  382.         (ProTracker is also on the "VideoTracker Utilities 1" disk)
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                 ================
  395.                 Command-Effects:
  396.                 ================
  397.  
  398. A command-effect will be directly shown on screen, a data-effect is
  399. used by the routines as a data-file.
  400.  
  401.  
  402. [Picture]    Loads an IFF-Picture into memory.
  403.         IFF is a picture-standard that is used by many drawing
  404.         programs like DeluxePaint, Cinemorph etc.
  405.         Also the colorcycle-information will be used in all
  406.         IFF files, with a maximum of 4. (Like in Deluxe Paint)
  407.         IMPORTANT: When colorcycle-information is found, it
  408.         will be turned on.
  409.         In DeluxePaint you can turn it on/off with the
  410.         "tab"-key, but VideoTracker always turns it on.
  411.         So if you don't want colorcycle, you have
  412.         to clear the "Ranges" in DeluxePaint.
  413.         
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422. [Brush]        Loads an IFF-Brush into memory.
  423.         The advantage of a brush is that it uses lesser memory then
  424.         a picture.
  425.         Pictures has standard sizes like 320*256, and you can size
  426.         a brush anyway you want.
  427.         I advice you to use x-sizes who are multiplies of 32, in
  428.         that way you won't have problems with routines that use
  429.         copper-effects. (example: 256, 288, 320, etcetra)
  430.  
  431. [Anim]        Loads an IFF-Anim5 animation into memory.
  432.         IFF Anim 5 is an animation-standard that is used by many
  433.         drawing programs like DeluxePaint, Cinemorph etc.
  434.         Also multiple-palette animations can be used.
  435.         An animation is realtime unpacked when it's played.
  436.         It uses 2 bufferscreens plus the animationdata from
  437.         memory.
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450. [AnimBrush]    Loads an IFF-Anim5 animation-brush into memory.
  451.         Anim-brushes are used in DeluxePaint.
  452.         An animation-brush will be completely unpacked by
  453.         VideoTracker.
  454.         In this way it is possible to use very
  455.         fast animationspeed and to use less processor-time.
  456.         But it will use a lot of memory, so remember:
  457.         Animations has standard sizes like 320*256, but you can
  458.         size an animation-brush anyway you want, which can be a
  459.         way to save memory.
  460.         An AnimBrush will also restart at frame 1 when it's
  461.         called, an animation would be to slow due to unpacking.
  462.  
  463. [Palette]    Loads an IFF-Palette into memory.
  464.         You can use this to show a picture with other colors, fade
  465.         the colors of the picture etc.
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478. [Routine]    Loads a routine that is written for VideoTracker.
  479.         This is the real power of VideoTracker, with these
  480.         routines you can make high-quality demos like
  481.         "Spaceballs" and "Jesus on E's".
  482.         Like you can see in the "Routines" section, you can use
  483.         filled vectors, plasmas, psychocircles, scrolls, 
  484.         etcetra, in many ways.
  485.         The (possible) 6-monthly updates of VideoTracker will
  486.         have the latest fashion-effects and ideas taken from
  487.         the latest megademos at that time.
  488.         The future Amiga's, like the A5000 and the follow-up of
  489.         the A1200, will have the possibility to expand them
  490.         to 8 megabytes of chip-memory, which means that you
  491.         can use up to 7,5 megs of routines.
  492.         On an A600 you can use 1 meg, on an A1200 2 meg which
  493.         is enough to make good videos, but with 8 meg you can
  494.         start to immitate MTV !
  495.         I personally can't wait and I'll have a lot of routines
  496.         ready at that time. :-)
  497.         "Routine mode:" selects the way a routine is played.
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.                 =============
  507.                 Data-Effects:
  508.                 =============
  509.  
  510. [Text]        Loads a text-file which can be used by one of the routines.
  511.         (Like the "Scroll" routine.)
  512.  
  513. [Object]    Loads an IFF-Animation-brush or IFF-Brush from the "Object"
  514.         directory.
  515.         These brushes are reformed for usage as blitter-objects
  516.         in routines like "Object".
  517.  
  518. [BackGround]    Loads an IFF-Picture or IFF-Brush wich can be used by
  519.         routines like "Object" as a background-picture.
  520.  
  521. [Font]        Loads an Amiga-font or a Kara-font which can be used by
  522.         routines like "Scroll".
  523.         A KaraFont is a colorfont that can be used in
  524.         DeluxePaint, you can edit or create them with
  525.         Calligrapher.
  526.         There are also some public domain Font and KaraFont
  527.         collection-disks.
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534. [Vector]    Loads a vector data-file which can be used in the
  535.         routines. (Like the "Vector" routine)
  536.         Supported formats:
  537.          
  538.         -Rot          This is a public domain 3D
  539.                 (three dimensional) object editor.
  540.                 It is on the "VideoTracker Public
  541.                 Domain" disk.
  542.  
  543.         -Imagine    A popular commercial raytracer.
  544.                 You don't need this program but there
  545.                 are a lot of detailed public domain
  546.                 3D objects, like Star-Wars spaceships,
  547.                 which are made with Imagine.
  548.                 Maximum object size: 50k.
  549.             
  550.         -IFF-Brushes    The brush will be translated to X/Y/Z
  551.                 pointers, so no lines are used.
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562. [Landscape]    Loads a landscape data-file which can be used in the
  563.         routines. (Like the "Landscape" routine)
  564.         Supported formats:
  565.          
  566.         I don't know exactly the names but there are 3
  567.         different formats: Raw-Z-value, Raw IFF heigth
  568.         difference & crunched IFF heigth difference.
  569.  
  570.         They are used by programs like "Vista Pro",
  571.         "Scenery Animator", "Terraform" & "Demmer".
  572.         
  573.         "Demmer" is ShareWare and is on the
  574.         "VideoTracker Public Domain 2" disk.
  575.         
  576. [Colorset]    Loads an IFF-Colorset or Palette into memory which can be
  577.         used in the routines. (Like the "CopperColors" routine)
  578.         Colorsets are used in DeluxePaint, they can hold up to
  579.         256 colors which can be changed using "spread" etcetra.
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590. =============================================================================
  591.                        How to make a simple video.
  592. =============================================================================
  593.  
  594. I'll explain how you can make a simple video with flashing brushes so
  595. you can get started.
  596.  
  597. You start VideoTracker Interactive.
  598. The first thing you must do is loading a music-module.
  599. You go to the right part of the control-screen, where all the load-gadgets
  600. are. (picture,brush,module etc.)
  601. You click the "Module" gadget and a file-requester appears.
  602. The "Modules"-directory is already selected and we pick the "Mod.Techno1"
  603. module by double-clicking it.
  604.  
  605. When the module is loaded, the control screen returns and you see the
  606. name of the module at the "Modulename:" gadget and the name of the first
  607. sample at the "Sample:" gadget.
  608. The modulename is "Techno1" and the first samplename is "Silent".
  609.  
  610. We now select the sample that is going to show the flashing brushes.
  611. You go to the left centre of the screen and click the gadget that
  612. shows the name of the sample with your RIGHT mousebutton, to select
  613. the sample "Beep" wich is number 8.
  614. You can't click the number of the sample.
  615. (The number of the sample is just information, and has no black
  616. background which means you can't change it.)
  617.  
  618. We're now going to load 2 brushes.
  619. Go to the "Load:" gadgets and click the "Brush" gadget.
  620. You now see a file-requester with the "Brush" directory already selected.
  621. Now double-click the "Techno_L8.bru" file.
  622. This is a brush that shows the word "TECHNO" in 8 color low-resolution.
  623. (I used the "_L8.bru" in the filename to remember the number of colors (8),
  624. resolution (L) and file-type (bru), but this is not needed in a file-name.)
  625.  
  626. When the control-screen returns, you see the filename at the left
  627. bottom of the screen in the "First effect:" and "Last effect:" gadgets.
  628. You loaded the brush into the effectlist at position 0.
  629.  
  630. Now go to the "First effect:" gadget and click on the brush-name with
  631. your RIGHT mousebutton to select effectposition "1".
  632. (You see also the "Last effect:" change to "1", because the last
  633. effect can't be smaller than the first effect.)
  634.  
  635. You now go again to "Load:" to load the second brush into
  636. effect-position "1".
  637. Click the "Brush" gadget and double-click the file "Skull_L8.bru".
  638. This brush shows a human skull in 8 color, low resolution.
  639. When the control-screen returns, you see the brushname in the
  640. "First effect:" gadget.
  641.  
  642. Now you click the "First effect:" gadget with your LEFT mousebutton
  643. to select effect "0".
  644.  
  645.  
  646. You now see:
  647.  
  648. "First effect: 0     Techno_L8.bru     "
  649. " Last effect: 1     Skull_L8.bru      "
  650.  
  651. You now go to the left-centre of the control-screen and change the
  652. "Priority:" value from "0" to "1" by clicking it with your RIGHT
  653. mousebutton.
  654. With this, you turn the sample on.
  655.  
  656. You now go again to the left-centre of the control-screen and set the
  657. "Effect Loop:" to "On" by clicking it with your left mousebutton.
  658. With this, the effects will start over again when the last effect
  659. is reached.
  660.  
  661. Now you're ready, but remember that you've edited this sample only
  662. for song-position "0", so when the song reaches song-position "1"
  663. the effects will stop.
  664.  
  665. Now go the the up-centre of the screen and click the "Play" gadget
  666. with you LEFT mouse and the show begins.
  667.  
  668. This is ofcourse a very simple and pretty boring effect but it's a
  669. start.
  670. You're also not restricted to use 1 sample in a songposition, you can
  671. use all the samples like you can see in the example-video "House".
  672.  
  673.  
  674. At the left-top of the screen, you see the "Song position:" gadget
  675. change while the song is playing.
  676. You can click this gadget to select the song-position you want to hear
  677. with the left- and right mousebutton.
  678.  
  679.  
  680. When you select song-position "0", this song-position will repeat untill
  681. you click "Play" again.
  682.  
  683. Now, I suggest, take a look at the example-videos to see all the 
  684. routines working.
  685. The "House" video is an example of a demo you could make with
  686. VideoTracker.
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702. =============================================================================
  703.                   Hints:
  704. =============================================================================
  705.  
  706. I already made some videos and I may have some tips for you:
  707.  
  708. -When you edit a sample, keep some space in the effectlist.
  709.  When the effectlist is empty at 10-20, start at position 15.
  710.  In that way, you can load effects before or after the current
  711.  effect. (Example: you want to add some palette-effects)
  712.  When you're done with some songpositions, you can use the "Clean Video"
  713.  option to pack the current effects.
  714.  
  715. -The more colors you use in a picture, the more time the Amiga needs
  716.  to show them, with the result that with 32 colors or more, the
  717.  copper is delayed. So copper-routines can't be used then. (On ECS)
  718.  Also the speed of routines will go slower.
  719.  The less colors you use, the faster the effects can be, the lesser
  720.  memory is used, the faster animations unpack.
  721.  With 8 colors or lower, you can also use Double Playfield, which can
  722.  be very nice.
  723.  I personally use low-color pictures & animations in videos that have
  724.  fast ritmes.
  725.  
  726.  
  727.  
  728.  
  729.  
  730. -When you want to use a complex animation of effects, it's handy to make
  731.  some fake-instruments.
  732.  You can use them to control the animation, like some sort of script.
  733.  I used this in the "Gabberuh!" video, to fade-in the clown slowly.
  734.  You make them empty, so you can't hear them.
  735.  And you can make them long (30000 bytes) and play them as the lowest
  736.  note (C-1) so they can play a long time.
  737.  Even as long as a songposition.
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758. =============================================================================
  759.             VideoTracker Developer Kit:
  760. =============================================================================
  761.  
  762. "The VideoTracker Developer Kit v1.0 Disk 1 (14-8-93) PUBLIC DOMAIN"
  763.  
  764. Contains the source-files of all the routines.
  765. I released these sources with the hope that some great demo-coders
  766. out there want to convert some of their great effects to the
  767. VideoTracker routine-format.
  768. You don't have to release your sources and you'll make a lot of people
  769. happy when they can use your effects in their videos.
  770. I already converted some PD-sources and it wasn't much work.
  771. When you send the routine-file (no source needed !) + manual to me,
  772. I can add it in the VideoTracker Manual with the author/group name.
  773.  
  774. Use Devpac 3 to assemble the sources.
  775. Remember to make your routine-source completely position-independent !
  776. (PC-relative or with a base-address, look at the example-sources to see
  777. how it can be done.)
  778. The example-sources also check on NTSC when they use a complex copper-list.
  779. It's not necessary but it would be nice for the Americans to see some
  780. real demos once. :-)
  781. When you remove the "Rout" label in the source, your routine-source will
  782. be assembled as a VideoTracker routine-file.
  783. You then can remove the hunk-information with, for example, Hunk Wizard
  784. and test it with VideoTracker.
  785.  
  786. =============================================================================
  787.                 Routines:
  788. =============================================================================
  789.  
  790. In this section all the routines are explained.
  791. In the "Plasma" manual is explained how the "routine-mode" is 
  792. calculated, but you don't have to know this because you can use
  793. the "Routinelist" to get the routine-mode you want.
  794. The "Plasma" is a very complicated routine to begin with.
  795. The "Star" routine has the easiest routine-modes, so I suggest that
  796. you start playing with that one.
  797. There are to many routines to understand at once, so when you make
  798. a video, select the routines you want and then start to read their
  799. manuals.
  800.  
  801. Some routines need vector-objects, (anim)brushes, text-files etc.
  802. An example how to use these files:
  803.  
  804. Effect Speed:    01
  805. First Effect:    05    Cube.vec    (This is a vector file)
  806. Last Effect:    06    Vector_L8.rot    (This is a routine file)
  807.  
  808. The vector file is detected by VT and stored in a table,
  809. The effect speed is 1 so the routine will be played directly.
  810. The routine checks the table and finds the vector file.
  811. In the example-videos this is used, so you can see how it
  812. works.
  813.  
  814. Routine:    Filename of the routine.
  815.  
  816. Picture:    Width * Heigth * Number of colors of the picture that is
  817.         used by the routine. You need to know this when you want
  818.         to play with the "Double Playfield" mode.
  819.         When the width * heigth is bigger then, or equals,
  820.         the viewable screensize (example: lores = 368*290)
  821.         and the colors are the same number, double playfield will
  822.         always be used.
  823.         
  824.         "-" = The routine does not use a picture.
  825.  
  826. View:        The viewmode of the picture:
  827.         "L" =     Low resolution    (Lo-Res)
  828.             Viewable screensize 368*290.
  829.         "H" =    High resolution (Hi-Res Interlaced)
  830.             Viewable screensize 736*580.
  831.         
  832. Copperlist:    Does the routine use a copperlist ?
  833.                 A copperlist is used by the routines to change for example
  834.                 the backgroundcolor several times on the screen.
  835.         "-" = The routine does not use a copperlist.
  836.  
  837. Memory:        Number of kilobytes that the routine uses in memory.
  838.         "?" = The routine is still under development.
  839.  
  840.  
  841.  
  842. Routine         Picture    View    Copperlist    Memory
  843. --------------------------------------------------------------
  844. ColorGrid     -        -    Yes        110
  845. CopperPalette_8     -        -    Yes        (Under Construction)
  846. CopperPalette_16 -        -    Yes        (Under Construction)
  847. Landscape_L2     368*290*2    L    -        (Under Construction)
  848. Landscape_L4     368*290*4    L    -        (Under Construction)
  849. Landscape_L8     368*290*8    L    -        (Under Construction)
  850. Landscape_L16     368*290*16    L    -        (Under Construction)
  851. Landscape_L32     368*290*32    L    -        (Under Construction)
  852. Object_H2     736*580*2    H    -        157
  853. Object_H4     736*580*4    H    -        307
  854. Object_H8     736*580*8    H    -        456
  855. Object_L2     368*290*2    L    -         59
  856. Object_L4     368*290*4     L    -        109
  857. Object_L8     368*290*8    L    -        160
  858. Object_L16     368*290*16     L    -        211
  859. Object_L32     368*290*32     L    -        261
  860. Object_EHB     368*290*64     L    -        312
  861. PictureMove     -        -    Yes          2
  862. Plasma         -        -    Yes        114
  863. Plasma_L2     368*290*2    L    Yes        (Under Construction)
  864. ScrollBig_L8     368*290*8    L    -        285
  865. ScrollNTSC_H4     736*468*4    H    -        358
  866. ScrollNTSC_L2     368*234*2    L    -         89
  867. ScrollNTSC_L16     368*234*16    L    -        243
  868. ScrollNTSC_L32     368*234*32    L    -        285
  869. Scroll_H2     736*580*2    H    -        209
  870. Scroll_H4     736*580*4    H    -        418
  871. Scroll_L2     368*290*2    L    -        136
  872. Scroll_L4     368*290*4    L    -        191
  873. Scroll_L8     368*290*8    L    -        183
  874. Scroll_L16     368*290*16    L    -        290
  875. Scroll_L32     368*290*32    L    -        302
  876. Stars_L8     368*290*8    L    -         56
  877. VectorShade_L2     368*290*2    L    Yes        171
  878. Vector_H2     736*580*2    H    -        315
  879. Vector_H4     736*580*2    H    -        459
  880. Vector_L2     368*290*2    L    -         97
  881. Vector_L4     368*290*4    L    -        133
  882. Vector_L8     368*290*8    L    -        169
  883. Vector_L16     368*290*16    L    -        205
  884. Vector_L32     368*290*32    L    -        241
  885. Wave         -        -    Yes          6
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898. =============================================================================
  899.  
  900. Routinename:    Plasma
  901. Authors:    Programmed by Roger Heykoop, converted by Peter van Campen.
  902. Version:    Without smooth plane, L2.
  903. Description:    Shows 3 sinuswaves on a backgroundcopperlist:
  904.         blue, green and red. When they overlap eachother they
  905.         mix their colors. (example: blue+green=cyan,
  906.         blue+red=purple, etc.)
  907.         As extra, there is a horizontal raster-sinus.
  908.         For each wave you can select the heigth, width and
  909.         direction (left/right) it moves to.
  910.         The result is a great psychadelic effect.
  911.         You can put a picture or brush over it.
  912.         This routine has up to 65536 different modes, a big
  913.         number but you can play a long time with this.
  914.  
  915.         There are 2 ways to get the right routine-mode.
  916.         The fast but difficult way is to calculate it
  917.         from the bitusage and the easy but slow way is to
  918.         get it from the routine-mode list.
  919.  
  920.         I'll explain how you can calculate it:
  921.         (It might be interresting for programmers who
  922.         read this)
  923.  
  924.  
  925.  
  926.         RoutineMode 16-bits (65536) bitusage:
  927.  
  928.  
  929.          3  1
  930.          2  6     4     1
  931.          7  3     0     0  5     1
  932.          6  8     9     2  1     2     3  1
  933.          8  4     6     4  2     8     2  6      4     1
  934.                 
  935.     |15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00|<-Bitnumber
  936.     |  |              |              |              |
  937.     |R |     Blue     |    Green     |     Red      |
  938.     |a |              |              |              |
  939.     |s |  |     |     |  |     |     |  |     |     |
  940.     |t |D | H   | W   |D | H   | W   |D | H   | W   |
  941.     |e |i | e   | i   |i | e   | i   |i | e   | i   |
  942.     |r |r | i   | d   |r | i   | d   |r | i   | d   |
  943.     |  |e | g   | t   |e | g   | t   |e | g   | t   |
  944.     |s |c | t   | h   |c | t   | h   |c | t   | h   |
  945.     |i |t | h   |     |t | h   |     |t | h   |     |
  946.     |n |. |     |     |. |     |     |. |     |     |
  947.      2  1    4     4   1   4      4   1    4     4     <-Settingsnumber
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.     Let's say, you want the green-bar with maximum heigth (4).
  955.     (No Police-Squad jokes please !)
  956.     You can see that bit 7 and 8 select it.
  957.     There are 2 bits, so there are 2^2=4 possible heigths.
  958.     Then these are the possible combinations:
  959.  
  960.     08 | 07        <Bitnumber
  961.     ---+----
  962.      0 | 0        Decimal value 0 = Minimum heigth
  963.      0 | 1        Decimal value 1 = 2 times sinus heigth
  964.      1 | 0        Decimal value 2 = 3 times sinus heigth
  965.      1 | 1        Decimal value 3    = 4 times sinus heigth (maximum)
  966.  
  967.     Now you take the value of bit 7 and multiply it with the decimal
  968.     value like this:
  969.     2^7 * 3    = 128 * 3 = 384
  970.     
  971.     Let's say, you also want the blue-bar with maximum heigth (4).
  972.     Bit 12 and 13 select it so:
  973.     2^12 * 3 = 4096 * 3 = 12288
  974.     
  975.     Now you add the results and you get the right routine-mode:
  976.     
  977.     384 + 12288 = 12672
  978.  
  979.  
  980.  
  981.  
  982.     But you can also use the routinemode list:
  983.  
  984. Routine mode    Description
  985. -----------------------------------------------------------------------------
  986. 0        Standard values:
  987.         All sinusses moving right, maximum width, minimum heigth
  988.         no horizontal raster-sinus.
  989.  
  990. 1        Red: 0.5 times sinus width.
  991. 2        Red: 0.33 times sinus width.
  992. 3        Red: 0.25 times sinus width.
  993. 4-7        Same as above but with Red: 2 times sinus heigth.
  994. 8-11        Same as above but with Red: 3 times sinus heigth.
  995. 12-15        Same as above but with Red: 4 times sinus heigth.
  996. 16-31        Same as above but with Red: sinus moving left.
  997.  
  998. 32-63        Same as above but with Green: 0.5 times sinus width.
  999. 64-95        Same as above but with Green: 0.33 times sinus width.
  1000. 96-127        Same as above but with Green: 0.25 times sinus width.
  1001. 128-255        Same as above but with Green: 2 times sinus heigth.
  1002. 256-383        Same as above but with Green: 3 times sinus heigth.
  1003. 384-511        Same as above but with Green: 4 times sinus heigth.
  1004. 512-1023    Same as above but with Green: sinus moving left.
  1005.  
  1006. 1024-2047    Same as above but with Blue: 0.5 times sinus width.
  1007. 2048-3071    Same as above but with Blue: 0.33 times sinus width.
  1008. 3072-4095    Same as above but with Blue: 0.25 times sinus width.
  1009.  
  1010. 4096-8191    Same as above but with Blue: 2 times sinus heigth.
  1011. 8192-12287    Same as above but with Blue: 3 times sinus heigth.
  1012. 12288-16383    Same as above but with Blue: 4 times sinus heigth.
  1013. 16384-32767    Same as above but with Blue: sinus moving left.
  1014.  
  1015. 32768-65535    Same as above but with the horizontal raster-sinus on.
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038. =============================================================================
  1039.  
  1040. Routinename:    Scroll
  1041. Authors:    Programmed by Peter van Campen.
  1042. Versions:    L2,L4,L8,L16,L32,L64,H2,H4,H8,H16
  1043. Description:    This routine is a text-viewer and scroller with many
  1044.         possibilities.
  1045.         You can use up to 16 different Fonts and also ColorFonts.
  1046.         And you need a text-file ofcourse.
  1047.         You can show the text on screen directly, you can scroll
  1048.         text horizontal to the right and to the left, you
  1049.         can scroll rows up, like in a movie-title.
  1050.         You can set the scrollspeed, you can delay, change the
  1051.         font-color, change the font-type, etcetra.
  1052.         All the rows are shown centered on screen, but you can
  1053.         also set the X/Y position or use reverse-centring if
  1054.         you like that.
  1055.         All the possibilities are used in the demo-videos.
  1056.         The routine doesn't use the routinemode but is controlled
  1057.         by commands in the text-file.
  1058.         The routine detects a command when it starts with the
  1059.         character "_".    
  1060.         "#" is a value which, for example, can be "15".
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.         Commands:
  1067.         
  1068.         _F#    Font: Changes the font.        
  1069.             Example:
  1070.             If you've loaded 3 fonts into memory, you can
  1071.             choose them with the values 0,1,2.
  1072.  
  1073.         _C#    Color: Changes the font-color.        
  1074.             Example:
  1075.             With no-color fonts you can have 31 different
  1076.             colors on a 32-color screen.
  1077.             With a 4 color-font you then have 32/4=8 different
  1078.             colorsets on that screen.
  1079.             With a 16 color-font you then have 32/16=2 different
  1080.             colorsets on that screen.
  1081.             So, with the right palette, you can make great
  1082.             color-scrolls.
  1083.  
  1084.         _S#    Speed: Changes the scroll-speed.
  1085.  
  1086.         _M#    Mode: Changes the view-mode.
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.             View modes:
  1095.             
  1096.             1    Left horizontal scroll.
  1097.             2    Right horizontal scroll.
  1098.             3    Up vertical scroll.
  1099.             5    Directly on screen.
  1100.             
  1101.         _X#    X-position    (horizontal)
  1102.             Sets the x-position of a character, for use in the
  1103.             print and vertical scroll mode.
  1104.  
  1105.         _Y#    Y-position    (vertical)
  1106.             Sets the y-position of a character, for use in the
  1107.             print and vertical scroll mode.
  1108.  
  1109.         _R#    Reverse
  1110.             Sets the right-border of a row which results in
  1111.             right centering.
  1112.  
  1113.         _D#    Delay
  1114.             Delays the routine.
  1115.  
  1116.         _E    Empty screen.
  1117.             Clears the screen
  1118.         
  1119.  
  1120.  
  1121.  
  1122.         Look at the example-texts to see how you should use
  1123.         these commands.
  1124.  
  1125.         To get the best speeds with double-playfield and with
  1126.         the several resolutions and to prefent a "shocking" effect
  1127.         on the scrolls,
  1128.         each version of the routine has different maximum font-
  1129.         heigths, also for the viewmodes.
  1130.  
  1131.         When there is no special NTSC version of a routine, it
  1132.         is not necessary or it is not possible because of the
  1133.         faster screen refreshing of NTSC.
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.         Here they are:
  1151.         
  1152.                   |   Maximum font-heigths    | Usable with
  1153.         Version   |                           | Double Playfield ?
  1154.               |  Horizontal  |  Vertical  |   PAL   |  NTSC
  1155.         ----------+--------------+------------+---------+---------
  1156.              L2      |     160      |      80    |     Yes    |  No
  1157.         NTSC L2      |     144      |      24    |  Yes    |  Yes
  1158.              L4      |      80      |      88    |  Yes    |  Yes
  1159.              L8      |      36      |      40    |  Yes    |  No
  1160.              L16  |      56      |      56    |  No    |  No
  1161.         NTSC L16  |      40      |      56    |  No    |  No
  1162.              L32  |      36      |      32    |  No    |  No
  1163.         NTSC L32  |      32      |      32    |  No    |  No
  1164.              H2      |      80      |      56    |  Yes    |  Yes
  1165.              H4      |      72      |      72    |  No    |  No
  1166.         NTSC H4      |      48      |      72    |  No    |  No
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178. =============================================================================
  1179.  
  1180. Routinename:    ScrollBig
  1181. Authors:    Programmed by Peter van Campen.
  1182. Versions:    L8
  1183. Description:    This is the same routine as the "Scroll" routine,
  1184.         but this one can handle the biggest fontsizes possible.
  1185.         I made this, so you can use most of the public domain
  1186.         KaraFonts.
  1187.         The reason I made 2 scroll-routines:
  1188.         The "Scroll" routine can scroll fast with double playfield
  1189.         and also scrolls fast on 16 and 32 colorscreens, but can't
  1190.         handle big fonts.
  1191.         The "ScrollBig" routine uses a lot more memory and
  1192.         scrolls bad with double playfield but is perfect to
  1193.         use with, for example, 80 pixels high 8-color fonts.
  1194.         
  1195.                   |   Maximum font-heigths    
  1196.         Version   |                           
  1197.               |  Horizontal  |  Vertical  
  1198.         ----------+--------------+------------
  1199.              L8      |      80      |      88    
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206. =============================================================================
  1207.  
  1208. Routinename:    Object
  1209. Authors:    Programmed by Peter van Campen.
  1210. Versions:    L2,L4,L8,L16,L32,L64,H2,H4,H8,H16
  1211. Description:    This routine can show up to 32 blitter-objects on screen.
  1212.         An object is an animbrush or brush file that is reformed
  1213.         for fast use with the blitter.
  1214.         You can make, for example, a logo with seperate bouncing
  1215.         letters on a 64-color picture.
  1216.         The routine reads the anim-speed for animbrushes,
  1217.         animloop is always on.
  1218.         The routine also needs a background-picture.
  1219.         If it hasn't got one, it will not clear to screen wich can
  1220.         be a nice effect too like you can see in the demo-videos.
  1221.         A background-picture is accepted when the size is the same
  1222.         as the viewable screen (example: lo-res= 368*290) and when
  1223.         the colornumber is the same.
  1224.         The routine copies the palette of the background-picture
  1225.         when it has the same number of colors, also when it's not
  1226.         accepted because of its size.
  1227.         In this way, you can turn of the clear and still change
  1228.         the palette.
  1229.         So the colors of the objects are not used !
  1230.         (So you can use the same object with different background-
  1231.         pictures.)
  1232.         The objects must have the same number of colors too.
  1233.  
  1234.         An object can move in 32 different ways and there are
  1235.         63 screen positions.
  1236.         There are 8 different move-sizes en 4 different move-speeds.
  1237.         
  1238.  
  1239.         There are 9 horizontal and 7 vertical screenpositions
  1240.         (9*7=63) and here is an example how to get the right one:
  1241.         
  1242.         The screen:
  1243.                  9 X-positions
  1244.                0 1 2 3 4 5 6 7 8       These are the values:
  1245.               +-----------------+    +--------------------------+    
  1246.             0 |     |        |    |00 01 02 03 04 05 06 07 08|
  1247.             1 |     |        |    |09 10 11 12 13 14 15 16 17|
  1248.         7    2 |------#        |    |18 19 20 21 22 23 24 25 26|
  1249.         Y-pos.    3 |            |    |27 28 29 30 31 32 33 34 35|
  1250.             4 |            |    |36 37 38 39 40 41 42 43 44|
  1251.             5 |            |    |45 46 47 48 49 50 51 52 53|
  1252.             6 |            |    |54 55 56 57 58 59 60 61 62|
  1253.               +-----------------+    +--------------------------+
  1254.  
  1255.         You want the "#" object on the above position, the way
  1256.         to get the right routine-mode is to multiply the
  1257.         y-position (2) with the total number of x-positions (9)
  1258.         and add the x-position wich gives: (2*9)+3=21
  1259.         Or, perhaps more easy, get the value from the right
  1260.         value-table.
  1261.  
  1262.         These are the possible moves:
  1263.         
  1264.         0    No movement.
  1265.         1    "O" Circle shaped, moving against clock-direction.
  1266.         2    "8" Eight shaped.
  1267.         3    "(X)" Eight-on-it's-side shaped.
  1268.         4    Very-weird shaped.
  1269.         5    "|" Goes up and down.
  1270.         6    "-" Goes left and right.
  1271.         7    "|" Goes up and bounces when it's down.
  1272.         8    "|" Goes down and bounces when it's up.
  1273.         9    "-" Goes left and bounces when it's right.
  1274.         10    "-" Goes right and bounces when it's left.
  1275.         11-16    No movement. (future expansion)
  1276.         17    "O" Circle shaped, moving with clock-direction.
  1277.         18-31    No movement. (future expansion)
  1278.         
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290. Routine modes:
  1291.  
  1292.         RoutineMode 16-bits (65536) bitusage:
  1293.  
  1294.          1
  1295.          6        2
  1296.          3        0
  1297.          8        4              6
  1298.              4        8              4                 1
  1299.                 
  1300.     |15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00|<-Bitnumber
  1301.     |     |        |              |                 |
  1302.     |Move-| Move-  |   Movetype   |   Screen-       |
  1303.     |speed|  size  |              |    position     |
  1304.        4      8          32               64    
  1305.                                                          
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318. Routine mode    Description
  1319. -----------------------------------------------------------------------------
  1320. 0        Movetype 0, Movesize 0, Movespeed 0.
  1321.         Y-position 0, X-position 0.
  1322. 1        X-position 1.
  1323. 2        X-position 2.
  1324. 3        X-position 3.
  1325. 4        X-position 4.
  1326. 5        X-position 5.
  1327. 6        X-position 6.
  1328. 7        X-position 7.
  1329. 8        X-position 8.
  1330.  
  1331. 9-17        Same as above but with Y-position 1.
  1332. 18-26        Same as above but with Y-position 2.
  1333. 27-35        Same as above but with Y-position 3.
  1334. 36-44        Same as above but with Y-position 4.
  1335. 45-53        Same as above but with Y-position 5.
  1336. 54-62        Same as above but with Y-position 6.
  1337.  
  1338. 64-127        Same as above but with Movetype 1.
  1339. 128-191        Same as above but with Movetype 2.
  1340. 192-255        Same as above but with Movetype 3.
  1341. 256-319        Same as above but with Movetype 4.
  1342. 320-383        Same as above but with Movetype 5.
  1343. 384-447        Same as above but with Movetype 6.
  1344. 448-511        Same as above but with Movetype 7.
  1345.  
  1346. 512-575        Same as above but with Movetype 8.
  1347. 576-639        Same as above but with Movetype 9.
  1348. 640-703        Same as above but with Movetype 10.
  1349. 1088-127    Same as above but with Movetype 17.
  1350.  
  1351. 2048-4095    Same as above but with Movesize 1.
  1352. 4096-6143    Same as above but with Movesize 2.
  1353. 6144-8191    Same as above but with Movesize 3.
  1354. 8192-10239    Same as above but with Movesize 4.
  1355. 10240-12287    Same as above but with Movesize 5.
  1356. 12288-14335    Same as above but with Movesize 6.
  1357. 14336-16383    Same as above but with Movesize 7.
  1358.  
  1359. 16384-32767    Same as above but with Movespeed 1.
  1360. 32768-49151    Same as above but with Movespeed 2.
  1361. 49152-65535    Same as above but with Movespeed 3.
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374. =============================================================================
  1375.  
  1376. Routinename:    ColorGrid
  1377. Authors:    Programmed by Peter van Campen.
  1378. Description:    Shows a 16*16 color-copperlist all over the screen.
  1379.         You can put a picture or brush over it.
  1380.         There are 3 16*16 colorgrids so for example you
  1381.         can see all 3 when you use the color-numbers
  1382.         0,1 and 9 in DeluxePaint.
  1383.  
  1384.         For each of the 3 grids, you can set one of the 2 modes
  1385.         and one of the 8 possible color-presets.
  1386.         
  1387.         There are 2 different modes:
  1388.         
  1389.         "Shading"    shows 256 colors on screen and changes them
  1390.                 into 16 shades.
  1391.         "Map"         Shows 256 colors out of a big colormap.
  1392.                 The map is moved around using a sinus-data.
  1393.  
  1394.         You can enable, disable or combine each of the grids,
  1395.         so you can speed up the routine or show a picture without
  1396.         the distortion of color 0, 1 or 9.        
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.         RoutineMode 16-bits (65536) bitusage:
  1403.  
  1404.                   4   2
  1405.                   0   0       2  1
  1406.                   9   4       5  2        1
  1407.                   6   8       6  8        6  8        1
  1408.                 
  1409.     |15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00|<-Bitnumber
  1410.     |  |        |           |           |           |
  1411.     |  |        |  Grid 3   |  Grid 2   |  Grid 1   |
  1412.     |  |        |           |           |           |
  1413.     |  |        |  |        |  |        |  |        |
  1414.     |  |  G S   | M|   C    | M|   C    | M|   C    |
  1415.     |  |  r e   | o|   o    | o|   o    | o|   o    |
  1416.     |  |  i l   | d|   l    | d|   l    | d|   l    |
  1417.     |  |  d e   | e|   o    | e|   o    | e|   o    |
  1418.     |  |  s c   |  |   r    |  |   r    |  |   r    |
  1419.     |  |    t   |  |        |  |        |  |        |
  1420.     |  |        |  |        |  |        |  |        |
  1421.            8     2     8     2     8     2     8 
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430. Routine mode    Description
  1431. -----------------------------------------------------------------------------
  1432. 0        Colors:        Grid 1: 0    Grid 2: Off    Grid 3: Off
  1433.  
  1434.         Colorgrid 1     Mode: Shading
  1435.         X: Black>Red    Y: Black>Green    Shading Blue
  1436.         Colorgrid 2 & 3 same as above.
  1437.  
  1438. 1        X: Black>Green    Y: Black>Blue    Shading Red
  1439. 2        X: Black>Blue    Y: Black>Red    Shading Green
  1440. 3        X: Black>Red    Y: Black>Blue    Shading Green
  1441. 4        X: Black>Green    Y: Black>Red    Shading Blue
  1442. 5        X: Black>Blue    Y: Black>Green    Shading Red
  1443. 6        X: Blue>Purple    Y: Blue>Cyan
  1444. 7        X: Red>Yellow    Y: Red>Purple
  1445. 8        Mode: Map    Mixed Red>Green>Blue
  1446.  
  1447. 16-31        Same as above but:
  1448.         Colorgrid 2:    X: Black>Green    Y: Black>Blue    Shading Red
  1449. 32-47        Same as above but:
  1450.         Colorgrid 2:    X: Black>Blue    Y: Black>Red    Shading Green
  1451. 48-63        Same as above but:
  1452.         Colorgrid 2:    X: Black>Red    Y: Black>Blue    Shading Green
  1453. 64-79        Same as above but:
  1454.         Colorgrid 2:    X: Black>Green    Y: Black>Red    Shading Blue
  1455. 80-95        Same as above but:
  1456.         Colorgrid 2:    X: Black>Blue    Y: Black>Green    Shading Red
  1457.  
  1458. 96-111        Same as above but:
  1459.         Colorgrid 2:    X: Blue>Purple    Y: Blue>Cyan
  1460. 112-127        Same as above but:
  1461.         Colorgrid 2:    X: Red>Yellow    Y: Red>Purple
  1462. 128-143        Same as above but:
  1463.         Colorgrid 2:    Mode: Map    Mixed Red>Green>Blue
  1464.  
  1465. 256-511        Same as above but:
  1466.         Colorgrid 3:    X: Black>Green    Y: Black>Blue    Shading Red
  1467. 512-1023    Same as above but:
  1468.         Colorgrid 3:    X: Black>Blue    Y: Black>Red    Shading Green
  1469. 1024-1535    Same as above but:
  1470.         Colorgrid 3:    X: Black>Red    Y: Black>Blue    Shading Green
  1471. 1536-2047    Same as above but:
  1472.         Colorgrid 3:    X: Black>Green    Y: Black>Red    Shading Blue
  1473. 2048-2559    Same as above but:
  1474.         Colorgrid 3:    X: Black>Blue    Y: Black>Green    Shading Red
  1475. 2560-3071    Same as above but:
  1476.         Colorgrid 3:    X: Blue>Purple    Y: Blue>Cyan
  1477. 3072-3583    Same as above but:
  1478.         Colorgrid 3:    X: Red>Yellow    Y: Red>Purple
  1479. 3584-4095    Same as above but:
  1480.         Colorgrid 3:    Mode: Map    Mixed Red>Green>Blue
  1481.  
  1482. 4096-8191    Same as above but:
  1483.         Colors:        Grid 1: 1    Grid 2: Off    Grid 3: Off
  1484. 8192-12287    Same as above but:
  1485.  
  1486.         Colors:        Grid 1: 9    Grid 2: Off    Grid 3: Off
  1487. 12288-16383    Same as above but:
  1488.         Colors:        Grid 1: 0    Grid 2: 1    Grid 3: Off
  1489. 16384-20479    Same as above but:
  1490.         Colors:        Grid 1: 0    Grid 2: 9    Grid 3: Off
  1491. 20480-24575    Same as above but:
  1492.         Colors:        Grid 1: 1    Grid 2: 9    Grid 3: Off
  1493. 24576-28671    Same as above but:
  1494.         Colors:        Grid 1: 0    Grid 2: 1    Grid 3: 9
  1495. 28672-32767    Same as above but:
  1496.         Colors:        Grid 1: Off    Grid 2: Off    Grid 3: Off
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514. =============================================================================
  1515.  
  1516. Routinename:    Stars
  1517. Authors:    Public Domain source, converted by Peter van Campen.
  1518. Versions:    L8
  1519. Description:    Shows a 3D moving starfield.
  1520.         Nothing more to explain.
  1521.  
  1522. Routine mode    Description
  1523. -----------------------------------------------------------------------------
  1524. 0        Normal
  1525. 1        Rotates stars left.
  1526. 2        Rotates stars right.
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542. =============================================================================
  1543.  
  1544. Routinename:    Vector
  1545. Authors:    Programmed by Peter van Campen, with help from
  1546.         Roger Heykoop.
  1547. Versions:    L2,L4,L8,L16,L32,L64,H2,H4,H8,H16
  1548. Description:    Shows 3D pixel vector, line vector, glass-filled vector
  1549.         filled vector, ball vector, symmetric-filled
  1550.         vector objects and rotates them.
  1551.         The routine needs a vector-file wich can be a
  1552.         Imagine-object, a Rot-object or a IFF-brush.
  1553.         The colors of the vector-files are also used.
  1554.  
  1555.  
  1556.  
  1557.         These are the possible view-modes:
  1558.         
  1559.         0    Pixel        Shows only the vector-coordinates as
  1560.                     pixels, very fast speed.
  1561.         1    Line        Shows the vector-lines, fast speed.
  1562.         2    Glass-filled    Shows the object with filled faces.
  1563.                     You can see the faces through
  1564.                     eachother which gives a glass-effect.
  1565.                     Medium speed.
  1566.         3    Filled        Shows the object with solid filled
  1567.                     faces. Slow speed.
  1568.  
  1569.  
  1570.         4    Balls        Shows only the vector-coordinates as
  1571.                     "Objects" (brushes or animbrushes).
  1572.                     Medium speed.
  1573.                     The color of a vector selects the
  1574.                     object-number, so you can use, for
  1575.                     example, 16 different blitter-objects
  1576.                     in one vector-object.
  1577.                     When you use a animbrush with, for
  1578.                     example, 10 frames. The first frame
  1579.                     will be shown when the vector is
  1580.                     distant, and the last frame will be
  1581.                     shown when the vector is forward.
  1582.                     So for a cool 3D effect, size
  1583.                     the frames from small to big.
  1584.                     The colors of the objects will be
  1585.                     copied and the number of colors must
  1586.                     be the same as the screen-colors.
  1587.  
  1588.         Tricky modes:
  1589.         (To speed up drawing)
  1590.  
  1591.         5    Symmetric-    Shows the object with solid filled
  1592.             filled        faces but draws only the most forward
  1593.                     faces. Is only usefull on symmetric
  1594.                     objects like, for example, cubes or
  1595.                     soccerballs. Medium speed.
  1596.                     
  1597.  
  1598.         You can choose for each of the X/Y/Z coordinates if they
  1599.         must rotate and if the object is moving forward or backwards.
  1600.         You can also set the speed of rotating and for special
  1601.         effects you can turn the double-buffering on/off so you can,
  1602.         for example, see how a big imagine-object is drawn as a
  1603.         solid filled-vector.
  1604.         You can also turn the clearscreen on/off so you can make
  1605.         a track of objects and you can clear the rotate-positions.
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.         RoutineMode 16-bits (65536) bitusage:
  1627.  
  1628.             8  4  2
  1629.             1  0  0           1
  1630.             9  9  4           2  6
  1631.             2  6  8           8  4        8  4  2  1
  1632.     |15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00|<-Bitnumber
  1633.     |     |  |  |  |           |  |        |  |  |  |
  1634.     |     |R |S |D |           |F |        | X| Y| Z|
  1635.     |     |o |c |o |           |o |        |  |  |  |
  1636.     |     |t |r |u |           |rB|        | R| R| R|
  1637.     |     |a |e |b | Rotation  |wa| Vector | o| o| o|
  1638.     |     |t |e |l |  speed    |ac|  mode  | t| t| t|
  1639.     |     |e |n |e |           |rk|        | a| a| a|
  1640.     |     |  |  |  |           |dw|        | t| t| t|
  1641.     |     |c |c |b |           | a|        | e| e| e|
  1642.     |     |l |l |u |           |or|        |  |  |  |
  1643.     |     |r |r |f |           |rd|        |  |  |  |
  1644.     |     |  |. |. |           |  |        |  |  |  |
  1645.               2  2      16      2     8     2  2  2                        
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654. Routine mode    Description
  1655. -----------------------------------------------------------------------------
  1656. 0        Moves forward.    Double-buffer on, Screenclear on,
  1657.         No rotation. Mode: Pixel-vector, Rotatespeed 0.
  1658. 1        Rotates Z.
  1659. 2        Rotates Y.
  1660. 3        Rotates YZ.
  1661. 4        Rotates X.
  1662. 5        Rotates XZ.
  1663. 6        Rotates XY.
  1664. 7        Rotates XYZ.
  1665.  
  1666. 8-15        Same as above but with Mode: Line
  1667. 16-23        Same as above but with Mode: Glass
  1668. 24-31        Same as above but with Mode: Solid
  1669. 32-39        Same as above but with Mode: Ball
  1670. 40-47        Same as above but with Mode: Symmetric
  1671.  
  1672. 64-127        Same as above but moves backwards.
  1673.  
  1674. 128-255        Same as above but with rotatespeed 1.
  1675. 256-383        Same as above but with rotatespeed 2.
  1676. 384-511        Same as above but with rotatespeed 3.
  1677. 512-639        Same as above but with rotatespeed 4.
  1678. 640-767        Same as above but with rotatespeed 5.
  1679. 768-895        Same as above but with rotatespeed 6.
  1680. 896-1023    Same as above but with rotatespeed 7.
  1681.  
  1682. 1024-1151    Same as above but with rotatespeed 8.
  1683. 1152-1279    Same as above but with rotatespeed 9.
  1684. 1280-1407    Same as above but with rotatespeed 10.
  1685. 1408-1535    Same as above but with rotatespeed 11.
  1686. 1536-1663    Same as above but with rotatespeed 12.
  1687. 1664-1791    Same as above but with rotatespeed 13.
  1688. 1792-1919    Same as above but with rotatespeed 14.
  1689. 1920-2047    Same as above but with rotatespeed 15.
  1690.  
  1691. 2048-4095    Same as above but with double-buffer off.
  1692.  
  1693. 4096-8191    Same as above but with screen-clear off.
  1694.  
  1695. 8192-16383    Same as above but with the rotate-positions cleared.
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710. =============================================================================
  1711.  
  1712. Routinename:    VectorShade
  1713. Authors:    Programmed by Peter van Campen, with help from
  1714.         Roger Heykoop.
  1715. Versions:    L2,H2
  1716. Description:    This is the same routine as the "Vector" routine
  1717.         and it uses the same routine-modes but this
  1718.         routine draws the object in 2 colors and shows
  1719.         the 4 last drawed frames behind the object which
  1720.         gives a very nice effect. (Used in the "House" video)
  1721.         It uses a copperlist to do this trick so you
  1722.         can't use double-playfield on this routine.
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738. =============================================================================
  1739.  
  1740. Routinename:    Wave
  1741. Authors:    Programmed by Peter van Campen.
  1742. Versions:    -
  1743. Description:    Puts a horizontal wave of 16 pixels into any picture or
  1744.         brush.
  1745.         The picture or brush width must be a multiply of 16.
  1746.         (example:240,368,144 etc.)
  1747.         
  1748. Routine mode    Description
  1749. -----------------------------------------------------------------------------
  1750. 0        Saw shaped.
  1751. 1        Saw shaped growing.
  1752. 2        Sinus shaped.
  1753. 3        Sinus shaped 4 sizes.
  1754. 4        ")" shaped.
  1755. 5        ")" shaped 3 sizes.
  1756. 6        "(" shaped.
  1757. 7        "(" shaped 3 sizes.
  1758. 8        Sinus shaped "Double Playfield" mixed.
  1759. 9        Sinus shaped normal mixed.
  1760.  
  1761. 16-31        Same as above but scrolling up.
  1762. 32-47        Same as above but scrolling down.
  1763.  
  1764. 64-127        Same as above but with 2 times vertical size.
  1765. 128-255        Same as above but with 3 times vertical size.
  1766. 256-511        Same as above but with 4 times vertical size.
  1767.  
  1768. 512-1023    Same as above but with 5 times vertical size.
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794. =============================================================================
  1795.  
  1796. Routinename:    PictureMove
  1797. Authors:    Programmed by Peter van Campen.
  1798. Versions:    -
  1799. Description:    Moves pictures that are bigger then the viewable
  1800.         screen in several ways.
  1801.         There are 2 seperate moves: the even planes and
  1802.         the odd planes.
  1803.         So when you use double playfield, you can give
  1804.         each picture it's own move:
  1805.         In double playfield, the front picture uses the
  1806.         even planes, the back picture uses the odd planes.
  1807.         In normal mode, the picture uses the even AND
  1808.         odd planes.
  1809.         When you don't use double playfield, you must
  1810.         set both moves the same if you want to see the
  1811.         picture like it is.
  1812.         If you don't, you get a weird effect that can be
  1813.         nice too, like you can see in the demo-video of
  1814.         this routine and in the "House" video.
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.         These are the moving-shapes:
  1823.  
  1824.         Value    |    Description
  1825.         --------+-----------------------------
  1826.          0    |    No move.
  1827.          1    |    "-"    Horizontal.
  1828.          2    |    "|"    Vertical.
  1829.          3    |    "O"    Circle-shaped.
  1830.          4    |    "(X)"    Eigth-on-its-side.
  1831.          5    |    "8"    Eight.
  1832.          6    |    Weird shape
  1833.          7-15    |    Not used.
  1834.              |    
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.         RoutineMode 16-bits (65536) bitusage:
  1851.  
  1852.                                            1
  1853.                                            6           1
  1854.                 
  1855.      |15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00|<-Bitnumber
  1856.      |                       |           |           |
  1857.      |                       |  Odd      |  Even     |
  1858.      |       (not used)      |   planes  |   planes  |
  1859.      |                       |     shape |    shape  |
  1860.      |                       |           |           |
  1861.                                  16          16    
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878. Routine modes:
  1879.  
  1880. Routine mode    Description
  1881. -----------------------------------------------------------------------------
  1882. 0        No moves.
  1883. 1        Even planes move "-"    Horizontal.
  1884. 2        Even planes move "|"    Vertical.
  1885. 3        Even planes move "O"    Circle-shaped.
  1886. 4        Even planes move "(X)"    Eigth-on-its-side.
  1887. 5        Even planes move "8"    Eight.
  1888. 6        Even planes move Weird shape.
  1889. 16-31        Same as above but the odd planes move "-"   Horizontal.
  1890. 32-47        Same as above but the odd planes move "|"   Vertical.
  1891. 48-63        Same as above but the odd planes move "O"   Circle-shaped.
  1892. 64-79        Same as above but the odd planes move "(X)" 8-on-its-side.
  1893. 80-95        Same as above but the odd planes move "8"   Eight.
  1894. 96-111        Same as above but the odd planes move Weird shape.
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906. =============================================================================
  1907.  
  1908.             (Future expansion)
  1909. Routinename:
  1910. Authors:
  1911. Versions:
  1912. Description:
  1913. Routine modes:
  1914.  
  1915.         RoutineMode 16-bits (65536) bitusage:
  1916.  
  1917.                                                         1
  1918.                 
  1919.      |15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00|<-Bitnumber
  1920.      |                       |           |           |
  1921.  
  1922. Routine mode    Description
  1923. -----------------------------------------------------------------------------
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934. =============================================================================
  1935.              Hard Disk Installation
  1936. =============================================================================
  1937.  
  1938. VideoTracker searches for the "VideoTracker:" device when it starts up.
  1939. When it hasn't found it, it uses the current directory.
  1940.  
  1941. So, first make a directory on your harddisk where you want to have the
  1942. VideoTracker directories.
  1943. I use the same directory where DeluxePaint and ProTracker get their files
  1944. from.
  1945.  
  1946. Let's say, you use the "Expansion" directory on your WorkBench. (Like I do)
  1947. You then must put this line in your startup-sequence:
  1948.  
  1949. "Assign VideoTracker: Expansion"
  1950.  
  1951. VideoTracker loads the fonts from your fonts-directory (Fonts:) so you
  1952. must copy the VideoTracker font-directory to the "Fonts:" directory.
  1953. Copy the "Libs" directory to your "Libs:" directory.
  1954. Then copy the data-directories (Modules, Video, Picture, etcetra)
  1955. to the expansion-directory.
  1956. You then can move "VideoTracker" to your WorkBench, or expansion-directory.
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962. =============================================================================
  1963.                  Libraries:
  1964. =============================================================================
  1965.  
  1966.         VideoTracker uses the following libraries:
  1967.         
  1968.                      ===========
  1969.                     Req.Library
  1970.                     ===========
  1971.  
  1972.     A Public Domain requester library used on 1.0-1.3 Amigas by the
  1973.     Interactive VideoTracker.
  1974.     On 2.0 and higher Amigas the Commodore "ASL.Library" is used when
  1975.     it is found.
  1976.  
  1977.                  ===================
  1978.                 Powerpacker.Library
  1979.                  ===================
  1980.  
  1981.     Used to decrunch modules, wich are packed with PowerPacker.
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.                    ===========
  1991.                    IFF.Library
  1992.                    ===========
  1993.  
  1994.     Is used for loading IFF-files into VideoTracker, but VideoTracker
  1995.     has it's own realtime animationplayer, so you DO NOT need to spread
  1996.     this library with your vidules !
  1997.     
  1998.  
  1999.                   THE UNIVERSAL IFF LIBRARY FOR THE AMIGA
  2000.                           VERSION 22.1, 02-Jun-92
  2001.                                     BY
  2002.                             CHRISTIAN A. WEBER
  2003.                                BRUGGERWEG 2
  2004.                               CH-8037 ZURICH
  2005.                                SWITZERLAND
  2006.                    INTERNET: weber@amiga.physik.unizh.ch
  2007.          (E-MAIL: cbmehq!cbmswi!mighty!chris@cbmvax.commodore.com)
  2008.  THIS PROGRAM IS IN THE PUBLIC DOMAIN. IT MAY BE FREELY DISTRUBUTED, COPIED
  2009.  AND USED FOR COMMERCIAL OR NON-COMMERCIAL PURPOSES.  IT MAY BE DISTRIBUTED
  2010.  WITH OR WITHOUT THIS DOCUMENTATION FILE.
  2011.  TO MAINTAIN COMPATIBILITY,  YOU SHOULD NOT MAKE ANY CHANGES TO THE LIBRARY
  2012.  ITSELF.  UPDATES WILL BE RELEASED BY THE AUTHOR.  HOWEVER, YOU MAY  CHANGE
  2013.  THE SOURCE CODES OR USE THEM IN YOUR OWN PROGRAMS.
  2014.  The iff.library is an easy to  use  Amiga  library  which  gives  you  some
  2015.  powerful routines to deal with IFF files, especially ILBM files (pictures),
  2016.  ANIM files (animations) and 8SVX files (digitized sounds).
  2017.  
  2018.  It was fully written in Assembler and is  only  3.2 KBytes  long.  The  de-
  2019.  compression routines are the fastest I've ever written :-)
  2020.  To use iff.library, copy it to the 'LIBS:' directory of your boot partition
  2021.  or Workbench disk.
  2022.  
  2023.  Since the iff.library is a standard Amiga library,  it can be used from any
  2024.  programming language such as C, C++, Modula-2, Assembler, Pascal, ARexx and
  2025.  many more.
  2026.  I started writing this library in September 1987, and now it is really bug-
  2027.  free (I hope) and it can handle any IFF files I know, including DPaint pic-
  2028.  tures with stencil,  HAM and halfbrite pictures, ANIM files (with a trick),
  2029.  SHAM files, SoundFX instruments,  and all other IFF files which do not con-
  2030.  tain nested chunks.
  2031.  If you have questions or suggestions, don't hesitate to contact me!
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046. =============================================================================
  2047.                 Demo Vidules info:
  2048. =============================================================================
  2049.  
  2050. Programs I used to create the modules, pictures, anims, vectors, etcetra:
  2051. (Not ment to make you buy them, but I think they're great !)
  2052.  
  2053.                 ==========
  2054.                 ProTracker
  2055.                 ==========
  2056.  
  2057. PROTRACKER 3.10 Beta. Amiga Format version, FreeWare.
  2058. Protracker 3.10 is (C) Copyrighted 1992-93 by the Authors.
  2059. This version of Protracker is a betaversion exclusively for the Amiga Format
  2060. magazine. Protracker 3.10 by Cryptoburners is the latest edition to the
  2061. Protracker family and is entirely based upon Protracker 1.3/2.0 by
  2062. Lars Hamre of The Amiga Freelancers.
  2063. Protracker V2.2 Release A - (C) 1992 Mushroom Studios/Noxious 22/06-1992
  2064. By Peter Hanning & Anders Ramsay, Public Domain.
  2065. (On the "VideoTracker Utilities 1" disk.)
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.                       ====
  2075.                   FFEX
  2076.                   ====
  2077.                                                                     
  2078. FFEX - The Fast Fractal Exploration Set V4.0
  2079. FFEX  computes  the  well  known  Fractals  and has all usual features like
  2080. loading  and  saving  (as IFF picture), different resolutions and different
  2081. algorithms  (Int_16  and  Int_32  are  faster, but have less precision than
  2082. Real).
  2083. This program is public domain.
  2084. Programmed by:
  2085. Robert Brandner / Schillerstr. 3 / A-8280 Fürstenfeld / AUSTRIA / EUROPE
  2086. (On the "VideoTracker Utilities 1" disk.)
  2087.  
  2088.                 ==========
  2089.                 Spirograph
  2090.                 ==========
  2091.  
  2092. Spirograph V1.0, Public Domain, by Peter van Campen.
  2093. A program based on the kids toy "Spirograph".
  2094. It calculates al kinds of spiral pictures using sinusses.
  2095. (On the "VideoTracker Utilities 1" disk.)
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.                              =================
  2103.                  Digital Illusions
  2104.                              =================
  2105.  
  2106. Digital Illusions, ShareWare, by Tonny Espeset.
  2107. Digital Illusions is a higly professional image processing program. Not
  2108. only is it capable of processing still pictures, but it will also let you 
  2109. create stunning animations from ordinary flat pictures using a powerful
  2110. 'In between' tecnique.
  2111. (On the "VideoTracker Utilities 1" disk.)
  2112.  
  2113.                      ========
  2114.                      Imploder
  2115.                      ========
  2116.  
  2117. Imploder V4.0, FreeWare, by Peter Struijk & Albert J. Brouwer.
  2118. A great executable-file cruncher.
  2119. Used to crunch the vidules.
  2120. (On the "VideoTracker Utilities 1" disk.)
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.                                    ===
  2131.                                    Rot
  2132.                                    ===
  2133.  
  2134. Rot V0.5, FreeWare.
  2135. Copyright (c)  04/04/87  C. French, Non-commercial copying encouraged!
  2136. All other rights reserved
  2137. ROT is a program to generate and display 3D objects. It is made up of
  2138. two sections: the OBJECT editor and the ACTION editor. The first is used
  2139. to create the database of your 3D object- each point's coords, and the
  2140. points used as verticies for each polygon. The second section defines
  2141. an action of 24 steps. At each step the position or orientation of the
  2142. object may be changed. When these steps or frames are replayed quickly
  2143. the object performs your action.
  2144. (On the "VideoTracker Utilities 1" disk.)
  2145.  
  2146.                                   ======
  2147.                                   WB Fed
  2148.                                   ======
  2149.  
  2150. WorkBench Font Editor v0.9, Copyright 1991 Patrick F. Clark.
  2151. A ShareWare (Color)Font editor, remember to set your WorkBench to
  2152. 16 colors.
  2153. (On the "VideoTracker Utilities 1" disk.)
  2154.  
  2155.  
  2156.  
  2157.  
  2158.                                =============
  2159.                                Fractal Mania
  2160.                                =============
  2161.  
  2162. Fractal Mania v0.37, Public Domain, by Zsolt Nagy.
  2163. Generates fractals with many options.
  2164. (On the "VideoTracker Utilities 1" disk.)
  2165.  
  2166.                                   ======
  2167.                   Demmer 
  2168.                                   ======
  2169.  
  2170. DEMMER (C) COPYRIGHT 1992 Bill McCarter All Rights Reserved, CRIPPLEWARE.
  2171. PURPOSE:
  2172. The purpose of this utility is to be able to take an IFF
  2173. graphic and transform it to a format readable by VISTAPRO. I
  2174. wanted to have a freeform method to produce landscapes and to
  2175. have an easy way to digitize topo maps rather than relying on
  2176. someone else to supply me with USGS data. VISTAPRO provides an
  2177. excellent engine for the development of realistic landscape
  2178. images.
  2179. There are also a few extra features that I added to provide
  2180. some image processing to smooth out transitions.
  2181. (On the "VideoTracker Utilities 2" disk.)
  2182.  
  2183.  
  2184.  
  2185.  
  2186.                                   ======
  2187.                   Plasma 
  2188.                                   ======
  2189.  
  2190. Plasma_32 v1.G, by Roger Uzun.
  2191. This program generates very colorful Plasma Cloud Fractals in 32 colors.
  2192. (On the "VideoTracker Utilities 2" disk.)
  2193.  
  2194.                                   ======
  2195.                   Slicer
  2196.                                   ======
  2197.  
  2198. Slicer v2.1, FreeWare, Copyright 1992 by Gary Teachout.
  2199. Slicer is a program for creating abstract art based on mathematical
  2200. functions, such as the Mandelbrot set, Julia sets, and related abstractions
  2201. (chaotic dynamical systems). Features include; fast fixed or floating point
  2202. arithmetic, many different functions (z²+c, z³-3a²z+b, sin(z) ...), many
  2203. computation options (level sets, binary decomposition, epsilon cross,
  2204. distance estimate), many coloring and rendering options, images may be
  2205. recolored without recomputing, batch mode, focus, multi pass, zoom in, zoom
  2206. out, pan, quick 2x zoom, and four dimensional navigation. The program is
  2207. named "Slicer" because the pictures it makes can be thought of as cross
  2208. sections or "slices" revealing the insides of solid (if imaginary) objects.
  2209. (On the "VideoTracker Utilities 2" disk.)
  2210.  
  2211.  
  2212.  
  2213.  
  2214.                                  ========
  2215.                  TreeGrow
  2216.                                  ========
  2217.  
  2218. TreeGrow V1.0, © 1992 by PARADISE SOFT, FREEWARE, by Benjamin Stegemann.
  2219. TreeGrow is a program which generates quasifractal trees or plants. Since
  2220. only a couple interations are done, they are not really fractal. I found
  2221. the idea in "Spectrum der Wissenschaft", the german release of "Scientific
  2222. American".
  2223. (On the "VideoTracker Utilities 2" disk.)
  2224.  
  2225.                                  =======
  2226.                  Scenery
  2227.                                  =======
  2228.  
  2229. Scenery v1.0, Public Domain, by Brett Casebolt.
  2230. Creates nice landscape-pictures.
  2231. (On the "VideoTracker Utilities 2" disk.)
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.                                   ======
  2243.                   Mostra
  2244.                                   ======
  2245.  
  2246. `Mostra' is (C) 1990,1991,1992 Sebastiano Vigna and it's $20 ShareWare.
  2247. `Mostra' 1.09, a shareware IFF utility featuring
  2248. real-time unpacking scroll, dozens of options, "smart" analysis of any
  2249. IFF file (FORMs, LISTs,...  also nested ILBM!), total control over
  2250. display modes, simple slideshow processing, pattern matching,
  2251. multipalette, double buffering, fast decompression, color cycling,
  2252. TeXdocs, startup files for easy custom configurations and complete WB
  2253. support.
  2254. (On the "VideoTracker Utilities 2" disk.)
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.                 =========
  2271.                 Cinemorph
  2272.                 =========
  2273.  
  2274. Cinemorph V2.06, Copyright 1992 Nova Design, by Thomas Krehhiel
  2275. It calculates smooth changing between 2 brushes.
  2276. (I love this one, You can also morph with Deluxe Paint 4, but this
  2277. program has more possibilities.)
  2278.  
  2279.                    ============
  2280.                    Deluxe Paint
  2281.                    ============
  2282.  
  2283. Deluxe Paint V4.1, Copyright 1985-1992 Electronic Arts, by Daniel Silva,
  2284. Lee Taran & Steve Shaw.
  2285. A great drawing program that also handles animations.
  2286. (Is mostly sold with your Amiga, so a lot of people have it.)
  2287.  
  2288.                  =======
  2289.                  PIXmate
  2290.                  =======
  2291.  
  2292. PIXmate v1.0, Copyright 1986-1987 Progressive Peripherals & Software,
  2293. by Justin V. McCormick.
  2294. Nice program to process a picture or its palette.
  2295.  
  2296.  
  2297.  
  2298.                                ============
  2299.                                Calligrapher
  2300.                                ============
  2301.  
  2302. Calligrapher, Copyright 1986 Inter/Active SoftWorks, by Edward Kilham.
  2303. A very good ColorFont editor, you can use the fonts in DeluxePaint and
  2304. VideoTracker.
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326. =============================================================================
  2327.                  About:
  2328. =============================================================================
  2329.  
  2330.     VideoTracker created by: Peter van Campen
  2331.         Routines created by: Peter van Campen & Roger Heykoop
  2332.          Modules created by: Dick Jansen, Robert Verkort &
  2333.                       Peter van Campen
  2334.        Some graphics created by: Peter van Campen, Roger Heykoop,
  2335.                  Maarten Kreuger & Peter van Burgh
  2336.            Hints & Tips: Roger Heykoop, Jaap Bleumink &
  2337.                     Martijn Thieme
  2338.             Testing: Roger Heykoop         A500 + 030/882
  2339.                  Klaas Reimes        A1200
  2340.                  Wim Rumping        A2000 + 030/882
  2341.                  Patrick Vervoorn    A4000
  2342.  
  2343.  
  2344.         To contact Peter "RattleHead" van Campen:
  2345.  
  2346. Paper mail:        Peter van Campen
  2347.             Tuinstraat 17
  2348.             1944 VTBeverwijk
  2349.             The Netherlands
  2350.             +31-(0)2510-15660
  2351.             PostBank 5739358 P.J. van Campen Jr.
  2352.  
  2353.  
  2354. Note:
  2355. - I answer all letters/requests, but include money or a disk as
  2356.   payment for stamps.
  2357. - Self-adressed envellopes can't be send out of The Netherlands
  2358.   with a foreign stamp on it. I mail these enveloppes but I'm not
  2359.   sure if they'll reach you.
  2360. - Foreign cheques are useless: the banks ask about 10 dollars to
  2361.   cash them.
  2362.   Dollars or disks are the best way to pay.
  2363.  
  2364. Digital mail:
  2365.  
  2366. Handle: "Peter van Campen"    Networks: AMY (International!), NLA,
  2367.                       Fidonet:Amiga.028,
  2368.                       Bosnet & DAN. (Software areas.)
  2369.  
  2370. BBS "The Red Dwarf": +31(0)2510-39479/47830    24H 2400-14400 v32bis
  2371.  
  2372. File-Area: 50: "RattleSoft"         Updates,Docs,Previews,Vidules etc.
  2373. Mail-Area:  9: "RattleHead Weet Raad"    Questions,hints,bug-reports etc.
  2374.  
  2375. You can order my collection, preview and update-disk by sending 5 dollars
  2376. in CASH (to small amount for cheques) to the above address.
  2377. If you want it, I can sent you the disk when I have released a new program.
  2378.  
  2379.  
  2380.  
  2381.  
  2382. You can also order the following Public Domain disks at 5 dollars a disk
  2383. or download them from the support-BBS:
  2384.  
  2385. "VideoTracker Video Examples 1"
  2386.     Contains 2 house-videos, a 512k and a 1024k chipmem-version,
  2387.     that demonstrate the power of VideoTracker. 120bpm
  2388.  
  2389. "VideoTracker Video Examples 2"
  2390.     Contains "Gabberuh!", a mega-big GabberHouse video which will need
  2391.     2mb of ChipMem. It's 6 minutes long, and reaches 240bpm. :-)
  2392.     This one is really cool !
  2393.     The following Amiga's have 2mb ChipRam: A1200, A4000.
  2394.     The following Amiga's are expandable to 2mb ChipRam: A600, A3000
  2395.  
  2396. "VideoTracker Scroll Examples"
  2397.     Contains example-videos that use the scroll-routines.
  2398.  
  2399. "VideoTracker Object Examples"
  2400.     Contains example-videos that use the object-routines.
  2401.  
  2402. "VideoTracker Vector Examples"
  2403.     Contains example-videos that use the vector-routines and
  2404.     the rest of the routines.
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410. "VideoTracker Utilities 1"
  2411.     Look at the "Demo Vidules Info" to see what's on this disk.
  2412.  
  2413. "VideoTracker Utilities 2"
  2414.     Look at the "Demo Vidules Info" to see what's on this disk.
  2415.  
  2416. "VideoTracker Vector-Objects 1"
  2417.     Contains a large collection of Imagine and Rot 3D vector-
  2418.     objects which you can use in your videos.
  2419.  
  2420. "VideoTracker Developer Kit 1"
  2421.     Contains the current routine-sources with comments so, when
  2422.     you're a coder, you can make your own VideoTracker routine-files.
  2423.  
  2424.  
  2425.  
  2426. I'm collecting PD ColorFont disks, Imagine 3D objects,
  2427. and more usefull utilities.
  2428. I'll keep you informed in the VideoTracker news-file wich can
  2429. be downloaded from the above BBS and will be spread with the
  2430. above disks.
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438. VideoTracker is programmed on:
  2439. A600HD           2M   chip     0K fast    PAL        Kick V2.0
  2440.  
  2441. It has been regular tested on:
  2442. A600HD           512K chip    0K fast    PAL        Kick V1.3 Emulate
  2443. A600HD           512K chip    0K fast    NTSC Emulate    Kick V1.3 Emulate
  2444. A600HD           1M   chip    0K fast    NTSC Emulate    Kick V2.0 
  2445. A600HD           2M   chip    0K fast    NTSC Emulate    Kick V2.0 
  2446. A2000HD 030/882    1M   chip    4K fast    PAL        Kick V2.0
  2447. A500HD 030/882     1M   chip    4K fast    PAL        Kick V2.0
  2448. A1200HD           2M   chip    0K fast    PAL        Kick V3.0
  2449. A1200HD           2M   chip    2K fast    PAL        Kick V3.0
  2450. A4000HD           2M   chip    4K fast    PAL        Kick V3.0
  2451.  
  2452.  
  2453. It should work on all configurations, GenLock and NTSC Amigas.
  2454. The current routines are written for 68000 Amigas, but they've been
  2455. tested on 68010 or higher.
  2456. When I have an Amiga 1200, I'll start to make special routines for
  2457. AGA, 68020 and 68882. (MBX 1200)
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.